--== READ ME ==--.txt
Tool to quickly save out PNG files from a wad of the 2D Map View. You can adjust the line thickness, set the background colour and also split the map into layers for easier editing in a 2D App.
It will draw all maps in the wad if not told what map to draw. use MAPxx or ExMx depending on if you are using Doom or Doom2.
========================================
map2png 1.2 - Doom map renderer
========================================
USAGE:
map2png source.wad [options]
OPTIONS:
-m, --map PATTERN Map to draw. Wildcards * and ? allowed.
Default: draws ALL maps in the WAD
-s, --size WIDTH Image width in pixels (default: 1024)
-t, --thickness N Line thickness (default: 1)
-b, --background [COLOR] Background fill. Bare -b gives black;
pass black or a hex code like #1ecbe1.
Omit the flag entirely for transparent
--layers Also write one PNG per line type
-h, --help Show this help and exit
OUTPUT:
<wad>-<MAP>.png All lines
<wad>-<MAP>_layer1.png Walls / one-sided (red) [--layers]
<wad>-<MAP>_layer2.png Two-sided (tan) [--layers]
<wad>-<MAP>_layer3.png Secret (yellow) [--layers]
<wad>-<MAP>_layer4.png Special / action (green) [--layers]
<wad> is the source WAD filename with no path or extension,
so doom2.wad + MAP09 writes doom2-MAP09.png into the CWD.
NOTES:
- Background is fully transparent unless -b is given
- Map names match case-insensitively (map01 finds MAP01)
- Height is derived from the map's aspect; -s sets width only
- Secret and special flags win over the one/two-sided colours
- Requires: omgifol, Pillow
EXAMPLES:
map2png doom2.wad
Draw every map in the WAD at the default 1024px
map2png doom2.wad -m MAP01
Draw a single named map
map2png doom2.wad -m "MAP*" -s 2048
Wildcard match, rendered at 2048px wide
map2png doom.wad -m "E?M4" -t 2 -b
All fourth maps, 2px lines, on a black background
map2png mywad.wad -b #1ecbe1
Custom hex background colour
map2png mywad.wad -m MAP09 --layers
Combined PNG plus the four per-line-type layer PNGs
map2png mywad.wad --layers -s 4096 -t 3
Big layered export for compositing in an image editor
----------------------------------------
How to use
----------------------------------------
Place the bat file and the script file
in a dir which has been added to your
path. Then simply run it via the bat
filename from any location on your
computer using the command line.
----------------------------------------
Python Dependancies
----------------------------------------
py -m pip install --upgrade pip
py -m pip install omgifol Pillow